Deavmi's coding shack
Commit d1b05db372649761fa04c1992ac03dd64648ccac
Parents : b4e1eaf
Author : Tristan B. Kildaire <deavmi@redxen.eu>
Date : 2021-11-02T11:58:24+02:00
Added some new notes
Changes
5 files changed, 77 insertions(+), 42 deletions(-)
Diff
diff --git a/new_docs/content/documentation/internals/parsing/_index.md b/new_docs/content/documentation/internals/parsing/_index.md
index 1a174f5..bbf21c7 100644
--- a/new_docs/content/documentation/internals/parsing/_index.md
+++ b/new_docs/content/documentation/internals/parsing/_index.md
@@ -1,5 +1,6 @@
---
title: Parsing
+date: 2021-11-01
---
This chapter aims to describe how the parser works in the T compiler.
@@ -12,7 +13,7 @@ The parser is the first part of the compiler where the structure of the source c
1. [Tokens I/O](tokens)
* Understand how the token I/O-subsystem allows retrieval and movement of/between tokens
-2. [Structures](structures)
+2. [Structures](structures/)
5. [Weighting](weighting)
\ No newline at end of file
diff --git a/new_docs/content/documentation/internals/parsing/structures/_index.md b/new_docs/content/documentation/internals/parsing/structures/_index.md
new file mode 100644
index 0000000..744b63d
--- /dev/null
+++ b/new_docs/content/documentation/internals/parsing/structures/_index.md
@@ -0,0 +1,15 @@
+---
+title: Structures
+date: 2021-11-01
+---
+
+## Introduction
+
+As we said in the introduction, we need to be able to create data structures for each entity of the program, eventually amounting in one super-structure of many smaller sub-strucrures (with their own children too) which represents the whole program's source code. This section will detail all of these structures and the common shared components alls structures have.
+
+---
+
+## Sections
+
+1. [Program](program)
+2. [Statments](statements)
\ No newline at end of file
diff --git a/new_docs/content/documentation/internals/parsing/structures/program.md b/new_docs/content/documentation/internals/parsing/structures/program.md
new file mode 100644
index 0000000..0309e34
--- /dev/null
+++ b/new_docs/content/documentation/internals/parsing/structures/program.md
@@ -0,0 +1,14 @@
+---
+title: Program structure
+date: 2021-11-01
+---
+
+## The _Program_
+
+The type declared as `Program` is a class that has the following main components to it which make it very important:
+
+1. `Statement[] statements`
+ * An array containining, in the order of parsing (of the source code), each and every statement at the program-level
+2. TODO: Nothing else to be honest
+
+**TODO:** Fill in
\ No newline at end of file
diff --git a/new_docs/content/documentation/internals/parsing/structures.md b/new_docs/content/documentation/internals/parsing/structures/statements.md
similarity index 60%
rename from new_docs/content/documentation/internals/parsing/structures.md
rename to new_docs/content/documentation/internals/parsing/structures/statements.md
index 7ce03bc..a269229 100644
--- a/new_docs/content/documentation/internals/parsing/structures.md
+++ b/new_docs/content/documentation/internals/parsing/structures/statements.md
@@ -1,25 +1,19 @@
---
-title: Structures
+title: Statements
date: 2021-11-01
---
## Introduction
-As we said in the introduction, we need to be able to create data structures for each entity of the program, eventually amounting in one super-structure of many smaller sub-strucrures (with their own children too) which represents the whole program's source code. This section will detail all of these structures and the common shared components alls structures have.
+This section will revise all statement-types and their contents.
----
-
-## The _Program_
+## Structures
-The type declared as `Program` is a class that has the following main components to it which make it very important:
-
-1. `Statement[] statements`
- * An array containining, in the order of parsing (of the source code), each and every statement at the program-level
-2. TODO: Nothing else to be honest
+Starting from most general to most specific, here, we will explain all the class types in the `compiler/symbols/data.d` file.
---
-## The _Statement_
+### Statement [`class`]
This is the holy grail of everything the parser generates. This is the top-level general representation-base of all structures. This means that this class represents the attributes that all structures that are sub-types of it (as you will see) will have. All parser methods produce some sub-type of the `Statement` type and return it for addition into either another _kinf-of_ statement or for immediate addition to the `Program`'s `statements` array.
@@ -38,4 +32,15 @@ Being a general top-type there isn't much it has but it has a few things all _ty
---
+### Entity [`class`]
+
+An Entity is any statement that represents a structure in T that is a named structure. The following structures in T are named and therefore will be represented as sub-type of the `Entity` type in the parser:
+
+1. Classes
+2. Variables (declarations)
+3. Function (declarations)
+4. Structs
+
+
+
TODO: Add now Entity, etc, VarAsign, VArAsignSTdALone etc
\ No newline at end of file
Served by rngit 1.5.0 - Generated in 0.08s